home *** CD-ROM | disk | FTP | other *** search
/ Risc World 3 / Risc World 3.iso / SOFTWARE / ISSUE6 / PD / PDF / !PDF / Documents / Help.txt < prev   
Text File  |  2003-02-24  |  10KB  |  269 lines
  1. !PDF
  2. ====
  3. PDF is a Public Domain PDF file viewer for RISC OS. It is a port of
  4. Derek B Noonburg's xpdf program and further develops Leo Smiers PDF program.
  5.  
  6. Contents
  7. ========
  8.      Copying and licences
  9.      Updates, bugs or problems
  10.      Iconbar icon
  11.      Main window
  12.      Button bar
  13.      Keyboard shortcuts
  14.      Printing
  15.      Find
  16.      Logical page numbering
  17.      Speed tips
  18.      !PDF limitations
  19.      Dynamic areas
  20.  
  21. Copying and licences
  22. ====================
  23. You may only copy/distribute/modify this program under the terms of the 
  24. GNU General Public Licence. Some of the source files are released under a
  25. modified BSD licence which is a GPL compatible licence.
  26.  
  27. The licences can be found in !PDF.Documents.Licences
  28.  
  29.  
  30. Updates, bugs or problems
  31. =========================
  32. You can get the latest version of !PDF at
  33.  
  34.    http://www.pdf.iconbar.com/
  35.  
  36. If you have any problems with !PDF you can contact me at
  37.  
  38.    mailto:colin@pdf.iconbar.com
  39.  
  40.  
  41. Iconbar icon
  42. ============
  43.  
  44. If you run !PDF an Iconbar icon will appear and you can quit the program
  45. >from the menu.
  46.  
  47. If !PDF is not running but you run it by double clicking on a file or
  48. it is run by another program eg a browser. It will not have an iconbar icon
  49. and the program is quit by closing it's windows.
  50.  
  51.  
  52. Main window
  53. ===========
  54.  
  55. When the pointer is over a link it changes to a hand. Clicking with select 
  56. follows the link in the same window. If you click with adjust the link is 
  57. loaded into a new window.
  58.  
  59. You can scroll the window contents by dragging them.
  60.  
  61. Clicking Adjust on the close icon opens the directory containing the file.
  62.  
  63.  
  64. Button bar - from left to right
  65. ==========
  66. Document Outline  If faded there is no Document Outline available. Clicking on the
  67.                   icon opens an Outline window and when it is open:
  68.                     * Click on an entry to go to that page.
  69.                     * Click adjust on an entry to go to that page in a new window.
  70.                     * Click on a boxed + to show more entries in the outline window.
  71.                     * Click adjust on a boxed + to open all entries with a boxed + or -,
  72.                       at the same level, at and below the clicked on box.
  73.                     * Click on a boxed - to hide some entries.
  74.                     * Click adjust on a boxed - to close all entries with a boxed + or -,
  75.                       at the same level, at and below the clicked on box.
  76.                     * Click on window background or outside window to close it.
  77.  
  78. History Back     Move backward through history of pages visited. eg if you follow
  79.                  a link selecting back will show the last page you looked at. If 
  80.                  the last page was in a different document it reloads that document.
  81.  
  82. History Forward  Reverses the effect of clicking Back.
  83.  
  84. Bookmarks        (4 small buttons) you can bookmark the current page by clicking
  85.                  adjust on one of the buttons. You can then go back to that page
  86.                  at any time by pressing select.
  87.  
  88. Document size    Shows the number of pages in the document.
  89.  
  90. Current page     Shows the current page. You can change the current page by
  91.                  entering the page number here. Note the page number 
  92.                  may be different to the one shown on the page.
  93.  
  94. Previous         Click Select moves back 1 screenful. If at the top of page you move
  95.                  to the bottom of the previous page.
  96.                  Click Adjust moves to the top of the previous page.
  97.                  <ctrl> Select moves back 10 pages.
  98.  
  99. Next             Click Select moves forward 1 screenful. If at the bottom of page 
  100.                  you move to the top of the next page.
  101.                  Click Adjust moves to the top of the next page.
  102.                  <ctrl> Select moves forward 10 pages.
  103.  
  104. Page slider      Browse through pages by clicking or dragging the slider
  105.  
  106.  
  107. KeyBoard shortCuts
  108. ==================
  109.  
  110. UP              Move back 1 screenful.
  111. <shift> UP      Move back 1 page.
  112. <ctrl> UP       Move back 10 pages.
  113.  
  114. DOWN            Move forward 1 screenful.
  115. <shift> DOWN    Move forward 1 page.
  116. <ctrl> DOWN     Move forward 10 pages.
  117.  
  118. +               scale by 140%.
  119. -               scale by 70%.
  120. *               scale 100%.
  121.  
  122. Print           Show print dialogue box.
  123.  
  124. TAB             History forward.
  125. <shift> TAB     History back.
  126.  
  127. <ctrl> F4       Find
  128.  
  129.  
  130. Printing
  131. ========
  132.  
  133. The display options 'No text' and 'No images' affect what is printed.
  134. Printing is always done in Accurate mode.
  135. Landscape printing has no effect when printing as a pamphlet.
  136.  
  137. Single sided printing
  138. ---------------------
  139.  
  140. all             Print all pages
  141. >from - to       Print pages from 'from' to 'to'
  142. copies          number of copies to print
  143.  
  144. Double sided printing
  145. ---------------------
  146.  
  147. Double sided printing requires Print setup to be correctly filled in for it to
  148. work properly. (Click setup on the Print dialogue box)
  149.  
  150. If your printer reverses the order of sheets then tick 'Reverses the sheet order'.
  151. If the paper is turned over by your printer tick 'Turns the paper over'.
  152. Once set you can save these settings.
  153.  
  154.   
  155. To control what pages to print you have 'all', the 'from-to' range and the
  156. 'start-end' range.
  157.  
  158. Start-End       The start-end range indicates the section of the document to be 
  159.                 printed so if you wanted to make a pamphlet from a chapter in a 
  160.                 document you would set 'start' to the first page in the chapter
  161.                 and end to the last page in the chapter. If the start end range
  162.                 is faded then the range defaults to the whole document.
  163.  
  164. All             Print all of the start-end range
  165.  
  166. From-To         The from-to range is used to specify the pages from the start-end 
  167.                 range you want to reprint. Note it will print whole sheets of paper
  168.                 so if you specify a from-to range of 1-1 you will get both sides
  169.                 of the sheet printed.
  170.  
  171.    Turning the paper over
  172.    ----------------------
  173.    When you have finished printing the first side you will be asked to turn the
  174.    paper over. At this stage you can cancel the printing and print the second
  175.    side at another time by selecting '2nd side' in the print dialogue box when
  176.    you print it.
  177.  
  178.    To turn the paper over you should ensure that the same end (short side) of
  179.    the paper is fed into the printer first so for example my laser doesn't turn 
  180.    the paper over when it stacks the paper so I need to turn it over ensuring 
  181.    that the same end of the paper is fed into the printer first.
  182.    My old inkjet turns the paper over so I just need to turn the paper round
  183.    so that the same end is fed into the printer first.
  184.  
  185.    To clarify:
  186.      'Turn the paper round' means move the end nearest you so that it is the end
  187.      furthest away from you keeping the same face of the paper uppermost.
  188.  
  189.      'Turn the paper over' means keeping the same end of the paper toward you turn
  190.      the paper over so that the bottom face of the paper is now at the top.
  191.  
  192.    The paper needs to be turned the same way whether you print as a pamphlet or
  193.    just double sided.
  194.  
  195.  
  196. Find
  197. ====
  198.  
  199. Find searches for the word entered either from the current page or from the
  200. beginning of the document. The search text is case insensitive.
  201.  
  202. Logical page numbering
  203. ======================
  204.  
  205. When viewing a pdf file you may find that the page number on the toolbar Ò0
  206. is different to the one shown on the page. This can occur, for example, 
  207. when there are contents pages which numbered separately from the main body 
  208. of the document. So, if there are 16 pages in the contents the toolbar page 
  209. number would show page 1, and be seen on the page as page 17. To go to page 80 
  210. you would have to type 96 into the page selector on the toolbar.
  211.  
  212. You can make the page selector use the same page number as displayed 
  213. on the page by:
  214. 1) going to a numbered page of the file...i.e. NOT a contents page.
  215. 2) going to the 'Set logical page number' dialogue box (in 'Misc') 
  216. 3) entering the number displayed on the rendered page.
  217.  
  218. Speed tips
  219. ==========
  220.  
  221. A page which consists mainly of type 3 fonts (you can tell them because the 
  222. fonts are not anti-aliased like RISC OS fonts) can be very slow to render 
  223. for example the RISC OS Annual report can take over 20 seconds to render
  224. a page, set 'No Type3 fonts' and the same page can take less than 2 seconds.
  225. Luckily font substitution works for the RISC OS Annual Report but it doesn't
  226. always.
  227.  
  228. Having the pdf file on a RAM disc can speed some pages up a lot - especially 
  229. if the page is filled with Type 3 fonts.
  230.  
  231. !PDF limitations
  232. ================
  233.  
  234. !PDF can't render fonts that are embedded in a pdf file directly, it tries to 
  235. use a substitute RISC OS font. This means that sometimes the text is not 
  236. rendered correctly.
  237.  
  238. !PDF doesn't support polygon path clipping so may get drawings wrong. Selecting 
  239. one of the settings on the 'Display menu' may allow you to see what you want if,
  240. for example, some text has been obscured.
  241.  
  242. If the display from !PDF isn't good enough, you could save the page/document as
  243. postscript and render the postscript file with Ghostview (distributed with 
  244. GhostScript).
  245.  
  246. Dynamic areas
  247. =============
  248.  
  249. By default PDF will look for memory in application space. This limits the maximum
  250. amount of memory available to PDF to about 28Mb. If you would like PDF to be able
  251. to use more memory you can make PDF use a Dynamic area by setting 
  252. PDF$DynamicAreaSize as follows:
  253.  
  254. To use application space.
  255. -------------------------
  256.      Unset PDF$DynamicAreaSize 
  257.   or  
  258.      Set PDF$DynamicAreaSize 0
  259.  
  260. To specify how much memory PDF can use.
  261. ---------------------------------------
  262.      Set PDF$DynamicAreaSize 64
  263.  
  264. where value, in this case 64, is in Mb. You choose the value you want.
  265.  
  266. To allow PDF to use as much memory as possible.
  267. -----------------------------------------------
  268.      Set PDF$DynamicAreaSize -1
  269.